home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Languages / Mops 2.7 / Mops source / SpeechStuff folder / README next >
Text File  |  1994-01-12  |  4KB  |  101 lines
  1. This README is a brief introduction to the Talker class I have written
  2. to support the Macintosh Speech Manager.  I will also briefly describe the
  3. other files I have included in this release.
  4.  
  5. The class Talker provides general access to every current call in
  6. release 1.1.1 of the Macintosh Speech Manager.  I have not (as I legally
  7. cannot) included the Speech Manager package in this release.
  8.     Most of the calls are poorly documented in the source.  If you are
  9. planning on using this package, you should obtain the documentation
  10. that has been release by Apple.
  11.  
  12. NOTE: I have not thoroughly checked every aspect of the Speech Manager.
  13. Only those specific things that you see in the demo file Speech have
  14. actually been tested, as that was the purpose of the file.  As you test
  15. other parts of the system, if you find bugs, please report them to me.
  16. I am operating under strict time constraints now, but I should have more
  17. time to work on this project intermittently in the future.  I will
  18. place my contact information at the end of this document.
  19.  
  20. KNOWN BUGS:
  21. Yes, there are some known problems that I just didn't have the time to
  22. work out.
  23.     • I do not seem to be handling the fixed points correctly, or else
  24.       the synthesizers that accompany the Speech Manager don't use the
  25.       fractional portions of the numbers.  In any case, everything comes
  26.       back to me as a whole number stored in the uppermost location on
  27.       the stack.
  28.     • I do not seem to be getting proper responses, even in the demo, to
  29.       pauseSpeechAt and stopSpeechAt.  I labored over those things for far
  30.       too long.  If someone can figure out what I doing incorrectly, I
  31.       would be happy to fix it.
  32.     • The demoed GetInfo doesn't even seem to work correctly, as it
  33.       doesn't respond correctly with the current bytes left in the
  34.       buffer or the current phoneme.  I like to believe that I misunder-
  35.       stand the concept of that call.  If you can find my mistake, please
  36.       let me know.
  37.       
  38. KNOWN LIMITATIONS:
  39. Indeed, there are some limitations.
  40.     • You can only access one set of information at a time.  I was working
  41.       with a list of the information for a while, but it was causing
  42.       some problems with complex manipulations. This really should not
  43.       be a problem, anyhow, as the information, theoretically, can change
  44.       instantly.
  45.     • I don't really know of any others, but they're probably there.  Feel
  46.       free to raise my consciousness of any you find.  I'll be happy to
  47.       get this going.  In all the current rush to get out information
  48.       about the Speech Manager, I just wanted to get something out in a
  49.       timely manner.
  50.       
  51. SOME REQUESTS:
  52. I'd like to make a few requests of you, the user of this package.
  53.     • If you find bugs, let me know.  I'd like to fix them.  If you can
  54.       and do fix them, please let me know of the fixes.
  55.     • If there are changes you would like to see made, please let me know.
  56.       This includes additions you might like to see happen.
  57.     • Try to test the parts I haven't tested.  In specific try to test out
  58.       the different selector options for GetInfo and PLEASE test out
  59.       the SetInfo and the Dictionary options.
  60.       
  61. INSTALLING:
  62.     • Get the Speech Manager and install it.
  63.     • Drag the file 'SpeechMgr' into whatever folder you like.  
  64.       I, personally, use ::Mops source:Toolbox classes:
  65.     • Drag the files 'Speech' and 'Utility Code' into whatever your
  66.       code folder is.
  67.     • Open up the Mops dictionary and type: // speech
  68.     • Type go.  It will lead you through what I have tested.
  69.              
  70.              
  71. SUMMARY:
  72. I did not write a complete exerciser-- everything has not been tested.  I
  73. did not have the time.  Sorry.  But I wanted to get this stuff out.
  74.  
  75. Try to find my bugs if you have a chance.
  76.  
  77. Try to find other bugs, especially in other areas of the class if
  78. you can.
  79.  
  80. Contact me if you have any comments, gripes or questions.
  81.  
  82. Oh yeah, the test file is called Speech.
  83.  
  84. CONTACTING ME:
  85. Electronic Mail (preferred):
  86.     gh1w+@andrew.cmu.edu
  87.     dietcoke+@cmu.edu
  88.     gregory.haverkamp@cmu.edu
  89.     (as I write this, all addresses send mail to the same place,
  90.     but the second one is more probably long-term.  And the '+' is
  91.     only somewhat necessary...  More so in the second address.)
  92.     
  93. Snail Mail:
  94.     6236 Fifth Avenue, Apartment 303B
  95.     Pittsburgh, PA 15232
  96.     
  97. Phone (I guess ya never know):
  98.     (412) 362-5487 (home)
  99.     (412) 268-2115 (off and on during the day -- not work, though)
  100.     
  101. And hey, let's be careful out there.